home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / iserv300.zip / ISERVER.DOC < prev    next >
Text File  |  1997-07-26  |  15KB  |  358 lines
  1.  
  2.    ▀  █▀▀ █▀▀ █▀█ █ █ █▀▀ █▀█
  3.    █  ▀▀█ █▀  █▀▄ █ █ █▀  █▀▄  I n t e r n e t   S e r v e r   R e l a y
  4.    ▀  ▀▀▀ ▀▀▀ ▀ ▀  ▀  ▀▀▀ ▀ ▀
  5.  
  6.    Copyright Multiboard Communications, 1994-1997
  7.    All rights reserved.
  8.  
  9.  
  10.  What does this program do?
  11.  ══════════════════════════════════════════════════════════════════════─────
  12.  
  13.    iServer will import email from a fidonet netmail format directly into
  14.    your RemoteAccess system as internet email.  No longer will your users
  15.    have to know anything about addressing to "UUCP" at some obscure netmail
  16.    address.  Of course, it will also export outbound mail from your BBS and
  17.    prepare them in a netmail fashion, ready to be gated out.
  18.  
  19.  
  20.  A complete solution!
  21.  ══════════════════════════════════════════════════════════════════════─────
  22.  
  23.    iServer is not only a tosser for your mail, but a powerful server engine
  24.    as well.  iServer can automatically bounce mail addressed to unknown
  25.    users on your system, or repond to inbound messages automatically.  With
  26.    iServer and its request/respond system, you can build powerful applica-
  27.    tions to interface with your basic email system, such as info-bots,
  28.    listserv and ftpmail.  Outbound messages can be restricted on site, user
  29.    security settings and the number of messages posted per user.  You also
  30.    have the option to restrict file transfers via email, such as UUENCODED,
  31.    BASE64 or MIME formatted messages.
  32.  
  33.    iServer integrates completely and seemlessly with your RemoteAccess
  34.    system, using it's data files for user verification, as well as obtaining
  35.    user security information for its message restricting features.
  36.  
  37.      ■ Seamless integration with RemoteAccess 2.x
  38.      ■ Direct import/export of email
  39.      ■ Powerful server response engine
  40.      ■ Bounce messages to unknown users
  41.      ■ Merge mailing lists as usegroups
  42.      ■ Restrict certain sites, functions or encoded files
  43.      ■ Custom templates for bounce messages
  44.      ■ Dumb address checking
  45.      ■ Disclaimer message support
  46.  
  47.  
  48.  What do I need to set this program up?
  49.  ══════════════════════════════════════════════════════════════════════─────
  50.  
  51.   In order to use this program you will need:
  52.  
  53.     1) Your system to use a fidonet style frontend mailer that *.MSG files
  54.        in it's inbound/outbound netmail directory.  (for example: FrontDoor,
  55.        Intermail and a number of others)
  56.  
  57.     2) RemoteAccess 2.x or another BBS software package that can use the
  58.        JAM message base format.
  59.  
  60.   Basic setup method:
  61.  
  62.     1) Create a message base on your BBS.  For RemoteAccess, it should
  63.        be an "Internet" or "Echomail" style area, "JAM" type with the
  64.        "Private" mail only setting.  This is not the same as your
  65.        regular netmail area.
  66.  
  67.     2) Run ISERVCFG.EXE to setup iServer.  (there is lots and lots of
  68.        online help, just press F1)
  69.  
  70.     3) Put ISERVER.EXE in your RUNBBS.BAT file, after receiving netmail
  71.        and after the user logs off (or optionally during an event)
  72.  
  73.     4) You're done!
  74.  
  75.  
  76.   Advanced setup method:
  77.  
  78.     This method, albeit a little more involved, will provide you with
  79.     the best setup, since it keeps your netmail and internet email
  80.     completely seperate from each other.
  81.  
  82.     Lets assume for this example that your standard fidonet address
  83.     is 7:8/9, you would:
  84.  
  85.     1) Complete steps 1 & 2 from the basic setup
  86.  
  87.     2) Create an aka in your mailer of 7:8/9.999
  88.  
  89.     3) Setup your site address in ISERVCFG as the above
  90.  
  91.        (* THIS IS THE BIG PART *)
  92.  
  93.     4) Setup your netmail tosser to ignore mail to 7:8/9.999.
  94.        (not import it into the netmail area in your BBS, since iServer
  95.        is the one that should be doing the importing for this mail)
  96.        Doing this means that your netmail/echomail tosser will never
  97.        accidentally grab the inbound mail that is meant for iServer.
  98.        If you do not use this advanced method, it means you must
  99.        *always* run iServer before your tosser imports netmail.
  100.  
  101.     5) You're done!  It really isn't much more difficult, but with
  102.        this method you can be sure that you will never have your
  103.        email and netmail crossed anywhere.
  104.  
  105.  
  106.  What can't I do until I register?
  107.  ══════════════════════════════════════════════════════════════════════─────
  108.  
  109.    Nothing.  The only limits that are imposed, are that you can only
  110.    have a maxium of 3 RESPOND entries, and 3 RESTRICTS until registered.
  111.    You also cannot use any TABLE entries until you have registered.
  112.    It will also remove the unregistered notice, and the 2 second delay.
  113.    Please register, a lot of effort went into developing the program,
  114.    and the price is quite reasonable.
  115.  
  116.    Please note that registration keys are built on your site address
  117.    and site name, so make sure that they are correct.
  118.  
  119.  
  120.  Special files
  121.  ══════════════════════════════════════════════════════════════════════─────
  122.  
  123.    ADDRESS.BAD    - Custom message to send when the user has addressed
  124.                     a message to what appears to be an invalid account.
  125.  
  126.    LIMIT.BAD      - Custom message to send when a user does not have
  127.                     sufficient credit to post a message.
  128.  
  129.    SITE.BAD       - Custom message to send when a user posts to a site
  130.                     that you have marked as restricted.
  131.  
  132.    SUBJECT.BAD    - Custom message to send when a user attempts to post
  133.                     to a function that you have restricted.
  134.  
  135.    USER.BAD       - Custom message to send to the originator of a message
  136.                     when an inbound message is not addressed to anyone
  137.                     valid on your system.
  138.  
  139.    UUENCODE.BAD   - Custom message to send when a user attempts to pass
  140.                     a encoded file through your gateway.
  141.  
  142.    DISCLAIM.MSG   - A custom disclaimer to add to the bottom of your
  143.                     outgoing messages.  Delete this file if you do not
  144.                     want one.
  145.  
  146.    RESPOND.MSG    - A custom template for creating request/respond
  147.                     files during a 'RESPOND' command.  If you wish to
  148.                     use the standard one (compatible with version 1.x)
  149.                     simply delete this file.
  150.  
  151.  Metalist Commands
  152.  ══════════════════════════════════════════════════════════════════════─────
  153.  
  154.    This is a list of the valid metastrings that can be used in return
  155.    messages, request 'return' files and 'respond' returned text files.
  156.  
  157.    %TO%                   - Who the message is to
  158.    %FROM%                 - Who the message if from
  159.    %DATE%                 - The date of the message
  160.    %SUBJECT%              - The subject of the message
  161.    %WHERETO%              - The Fidonet destination
  162.    %WHEREFROM%            - The Fidonet source
  163.    %SITENAME%             - The name of the processing site
  164.    %SERVER%               - The name of the processing server
  165.    %SITEADDR%             - The Fidonet address of the site
  166.    %UUCPADDR%             - The Fidonet address of the gate
  167.    %ORIGTO%               - Who the message was originally to     *
  168.    %ORIGFROM%             - Who the message was originally from   *
  169.    %ORIGSUBJECT%          - The original subject of the message   *
  170.  
  171.    .TO.                   - Who the message is to                 .
  172.    .FROM.                 - Who the message if from               .
  173.    .ORIGTO.               - Who the message was originally to     .
  174.    .ORIGFROM.             - Who the message was originally from   .
  175.  
  176.    ^TO^                   - Who the message is to                 ^
  177.    ^FROM^                 - Who the message if from               ^
  178.    ^ORIGTO^               - Who the message was originally to     ^
  179.    ^ORIGFROM^             - Who the message was originally from   ^
  180.  
  181.  Notes:
  182.  
  183.  * Normally the "ORIG" values are the same as the normal to/from/subject
  184.    except when messages are being returned or re-routed.
  185.  
  186.  . Same as normal, except replacing doing a period->underscore and a
  187.    space->period conversion of the standard text.
  188.  
  189.  ^ Same as normal, except autocapitized versions of the standard text.
  190.    For example: "pete rocca" becomes "Pete Rocca"
  191.  
  192.  
  193.  Command line parameters
  194.  ══════════════════════════════════════════════════════════════════════─────
  195.  
  196.    Typing ISERVER /? will bring up a list of command line options.
  197.    Normally, just running ISERVER.EXE is sufficient, but there are
  198.    other options available.
  199.  
  200.    Import/export mail parameters
  201.  
  202.       /PROCESS                     Standard behaviour (default)
  203.       /FORCE                       Ignore last scanning markers
  204.       /NOMARK                      Do not update high scan marks
  205.       /NOSCAN                      Do not scan for outgoing mail
  206.       /NOTOSS                      Do not toss incoming mail
  207.  
  208.    Online programs and parameters
  209.  
  210.       /USERID droppath             Userid creation (if flag not toggled)
  211.       /USERID droppath /FORCE      Userid creation (always)
  212.  
  213.    Utilities
  214.  
  215.       /TABLE tablename [+|-]user   Add/remove user from a table
  216.  
  217.  
  218.  
  219.    What is /USERID?
  220.  
  221.    This program simply gives the user an interface to change their
  222.    user alias to something that looks more professional on the internet
  223.    if they wish.  You can setup restrictions for this alias in the
  224.    ISERVCFG program.
  225.  
  226.    To implement this, you would change the message area on the BBS to
  227.    "Use Handles Only" which would then post the message from their
  228.    alias.  This way, they can have a name like "roccap@yoursite.com"
  229.    if they choose.
  230.  
  231.    The online program options are to run the userid (handle creation)
  232.    part of the program.  The /FORCE overrides if the user has already
  233.    set the user flag as defined in ISERVCFG.
  234.  
  235.    Examples:  ISERVER.EXE /USERID c:\ra\node1 /FORCE
  236.               ISERVER.EXE /USERID c:\ra
  237.               ISERVER.EXE /USERID c:\ra\node2
  238.  
  239.    Please note that this utility is completely optional and not required
  240.    for the operation of iServer.
  241.  
  242.  
  243.    What is /TABLE?
  244.  
  245.    Tables are simular to "Responds", except you can put a class of
  246.    user names into a table rather than having a seperate trigger
  247.    for each user.
  248.  
  249.    For example, you could have a table of users that were on
  250.    vacation, and if someone posted a message to a user that was in
  251.    the vacation table, it could send them back a message saying
  252.    that they would be delayed in responding.  You could also have
  253.    a table of bad users, and have their inbound mail deleted.
  254.  
  255.    To insert a user into a table, use the following command:
  256.  
  257.    ISERVER /TABLE tablename +User Name
  258.  
  259.    To remove a user from a table, replace the plus sign (+) with a minus
  260.    sign (-).  In the vacation table example, you could allow an option
  261.    from your BBS that allowed them to toggle their own status.
  262.  
  263.    For example:
  264.  
  265.      Vacation
  266.  
  267.        (Y)es    ..  would run ISERVER /TABLE VACATION +*F *L
  268.        (N)o     ..  would run ISERVER /TABLE VACATION -*F *L
  269.  
  270.    Where your BBS would replace *F *L with the user name.
  271.  
  272.    Please note that this utility is completely optional and not required
  273.    for the operation of iServer.
  274.  
  275.  
  276.  Online help
  277.  ══════════════════════════════════════════════════════════════════════─────
  278.  
  279.    The ISERVCFG.EXE program has complete context-sensitive help online
  280.    to provide the easiest method of setting up.  Simply press F1 from
  281.    almost anywhere in the program for help about the menu you are in.
  282.  
  283.  
  284.  Function logging legend
  285.  ══════════════════════════════════════════════════════════════════════─────
  286.  
  287.     ■ - Program startup
  288.     I - Import message
  289.     E - Export message
  290.     B - Bounce message (Unknown user on this system)
  291.     T - Infobot trigger response
  292.     M - Merge mailing list
  293.     X - Table trigger response
  294.     R - Restricted
  295.     C - Consume message (Circular route detection)
  296.     U - Userid selected
  297.  
  298.  
  299.  License and disclaimer
  300.  ══════════════════════════════════════════════════════════════════════─────
  301.  
  302.    "iServer" (also known as "ISR") is NOT free.
  303.  
  304.    It is being marketed under the "try before you buy" or shareware
  305.    concept.  You are entitled to use ISR for a period up to forty-five
  306.    (45) days, after which you MUST register or stop using the program.
  307.  
  308.    Registration entitles you to use ISR as well as any future versions
  309.    of this program that may or may not be released, subject to any
  310.    additional licensing conditions which may be attached.
  311.  
  312.    Registration will also allow you to you the full ability of iServer
  313.    as well as remove the unregistered notice. It will also help to
  314.    continue to develop this program. (not to mention maintain the
  315.    legality of this agreement)
  316.  
  317.    By running any of the executable programs included, you agree that
  318.    Pete Rocca,  Multiboard Communications nor any affiliates of the
  319.    above mentioned are responsible for any damage ever experienced,
  320.    however so created. If you cannot agree to this, then your privilege
  321.    to use any of these programs is revoked and it becomes illegal for
  322.    you to execute any programs included with this documentation.
  323.  
  324.    You may freely copy and distribute the shareware version of ISR as
  325.    long as its original archived contents are not modified in any way.
  326.    You may NOT distribute any registration keys without the express
  327.    written consent of Pete Rocca of Multiboard Communications.
  328.  
  329.    You may not use a registration number that is not licensed from
  330.    Multiboard Communications directly to you.
  331.  
  332.    It is illegal to edit, alter, hack, reverse engineer and / or modify
  333.    any components of the ISR archive in any manner.
  334.  
  335.    If dispute of any issues on legal grounds said above, then governing
  336.    law of Ontario, Canada will rule.
  337.  
  338.  
  339.  Support
  340.  ══════════════════════════════════════════════════════════════════════─────
  341.  
  342.    iServer is now freeware and does not have any author support.  You
  343.    can visit our web site which has product information and tips and
  344.    tricks.  We also have a Fidonet echo MCC_SUPPORT which is a great
  345.    peer support echo.
  346.  
  347.    http://www.multiboard.com/
  348.    ftp://ftp.multiboard.com/
  349.  
  350.  
  351.  Acknowledgments
  352.  ══════════════════════════════════════════════════════════════════════─────
  353.  
  354.    Requires at least DOS 3.3 and SHARE.EXE loaded for the JAM routines.
  355.    Thanks to the public domain swapping utils that required very little
  356.    in the way of tweaking, by Thomas Wagner. iServer/ISR are copyrighted
  357.    products by Multiboard Communications and Pete Rocca.
  358.